Upgrading Wialon Local | Wialon Local

How to Upgrade Wialon Local from v1704 to v1804

upgrading_wialon_local

This guide describes the sequence of steps you should follow if you want to upgrade Wialon Local from version 1704 to version 1804.

In order for Wialon local version 1704 and above to function correctly, the Node.js 6.x package is required. Support for older versions of Node.js, starting with the release of 1804, is discontinued.

The official Debian 8 and Debian 9 repositories include earlier versions of packages. When installing from our distribution package, the required Node.js version is installed automatically.

Upgrade Node.js to the version 6.x if you receive a notification that the version of Node.js that is used on your server is out of date. To do this, follow the steps below.
- Log in to the terminal on behalf of the main user (root) and run the following commands:
  cd /home/wialon/wlocal/ service wlocal stop ./adf_script stop apt-get install -y curl curl -sL https://deb.nodesource.com/setup_6.x | bash - apt-get install -y nodejs npm -g install forever npm install chown -R wialon:wialon /home/wialon/ service wlocal restart
- Check the availability of your sites after they restart.
To update Node.js, you can also contact technical support. In this case, in the letter specify SSH credentials (IP, login and password) to access the server console.
The instruction is also located on the official site of the Node.js developer.
Install the version 1804 of Wialon Local.

How to Upgrade Wialon Local from v1804 to v1904

upgrading_wialon_local

When upgrading Wialon Local from version 1804 to version 1904, follow the steps below.

Make sure that the Debian operating system has been upgraded to version 9 (Stretch).

When updating from Debian 8 to Debian 9, add a line “include /etc/nginx/modules-enabled/*.conf” to the file /etc/nginx/nginx.conf . Here is an example of the received file:

user www-data;
worker_processes  2;
worker_rlimit_nofile 65535;
include /etc/nginx/modules-enabled/*.conf;

error_log  /var/log/nginx/error.log;
pid        /var/run/nginx.pid;

events {
       worker_connections  65535;
}

http {
       include       /etc/nginx/common/*;
       include       /etc/nginx/conf.d/*;
}

Add additional options (listed below) to the nginx configuration files for the admin site (/etc/nginx/conf.d/lcm.conf). Add the options to the location element of the server section of the lcm.conf file and to the configuration of other nginx involved in proxying requests. This is required to activate work using web sockets.

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";

Example of the lcm.conf configuration file:

server {
    listen        80;
    server_name    10.10.10.10;
    client_max_body_size 10000m;
    proxy_read_timeout 500;
    location /50x.html {
        root /home/wialon/wlocal/nginx/www/nginx-default;
    }    
    location / {
        if ( $args ~* dns-test ) {
            echo 1;
        }
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";       
        proxy_pass         http://localhost:8080;
    }
    access_log /var/log/nginx/lcm.access.log;
}

Install the ripgrep utility. It is required for quick reading of statistical information about the status of the server.

wget --no-check-certificate http://ftp.br.debian.org/debian/pool/main/r/rust-ripgrep/ripgrep_0.10.0-2_amd64.deb -O /tmp/ripgrep.deb
dpkg -i /tmp/ripgrep.deb

Install the version 1904 of Wialon Local.

How to Upgrade Wialon Local from v1904 to v2004

upgrading_wialon_local

To upgrade Wialon Local from version 1904 to version 2004, follow the steps below.

Upgrade the operating system Debian to the version 10 (Buster).

Install the pigz and curl utilities. To do this, log in to the terminal on behalf of the main user (root) and run the following command:

apt-get install pigz curl

Upgrade Node.js to the version 10.x, by running on behalf of the main user (root) the following commands:

cd /home/wialon/wlocal/
service wlocal stop
./adf_script stop
apt-get install -y curl
curl -sL https://deb.nodesource.com/setup_10.x | bash -
apt-get install -y nodejs
npm -g install forever
npm install
chown -R wialon:wialon /home/wialon/
service wlocal restart

Check the availability of your sites after they restart. To update Node.js, you can also contact technical support. In this case, in the letter specify SSH credentials (IP, login and password) to access the server console. The instruction is also located on the official site of the Node.js developer.

Install the version 2004 of Wialon Local.